home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 12 / Cream of the Crop 12 (Part II) / Cream of the Crop 12 (Part II).iso / BBS / RANDOM13.ZIP / RANDOM.DOC < prev    next >
Encoding:
Text File  |  1996-03-15  |  18.6 KB  |  661 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                                   RANDOMIZER v1.3
  15.  
  16.              A program to randomly change your PRELOG and GOODBYE files.
  17.                                                          
  18.                        (C) Copyright 1995, 96 Sapphire Software
  19.               
  20.                             Released on March 15, 1996
  21.  
  22.                 Written by Scott J. Bradbury of The Coral Reef BBS
  23.                         "A Unique Underwater BBS Experience"
  24.                             
  25.                            BBS Support:  (517) 894-0729
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.                         For use with Wildcat! BBS Software
  60.  
  61.  
  62.  
  63.         RANDOMIZER v1.0                                        INTRODUCTION
  64.         -------------------------------------------------------------------
  65.  
  66.         INTRODUCTION
  67.  
  68.         This program has been written using WC-Code by Mustang Software and   
  69.         will ONLY work on a Wildcat! BBS System.
  70.  
  71.  
  72.         PRODUCT DESCRIPTION
  73.  
  74.         Many years ago I operated a BBS on a Commodore 64.  (Yes, it is
  75.         possible!)  The software had the capability to randomly select an
  76.         intro file from a range of those created and display it to the 
  77.         user before they signed on.  I have written this program to
  78.         perform this function as Wildcat! does not have this option written
  79.         internally to it's source code.  An optional feature to randomly
  80.         change the GOODBYE.BBS file has also been incorporated.
  81.         
  82.         I have named this program Randomizer although it actually uses an        
  83.         index file to keep track of which display file is to be used next.
  84.         Future upgrades of this software may include a method to display
  85.         files in a set order or to randomly pick from a range of files. 
  86.         For this reason, I named the program as I have.
  87.  
  88.         Randomizer will change your PRELOG.BBS file and optionally, your
  89.         GOODBYE.BBS file every time a new caller signs on your system.
  90.         This will let you create several prelog files so that your users
  91.         don't grow tired of looking at the same screen all the time.
  92.  
  93.  
  94.         EVALUATION POLICY
  95.  
  96.         RANDOMIZER v1.0 is a fully functional program designed to change
  97.         your PRELOG.BBS and GOODBYE.BBS display files.  This program is 
  98.         not disabled in any way and does not require any registration
  99.         number or special key for operation.  The author reserves the
  100.         right to change this policy in future versions.  
  101.  
  102.         Randomizer v1.0 is listed as SHAREWARE.  However, donations 
  103.         toward the improvement of this and other products are always welcome.
  104.  
  105.  
  106.  
  107.         
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.         -------------------------------------------------------------------
  119.                                                                      Page 1
  120.  
  121.  
  122.  
  123.         RANDOMIZER v1.0                                   TECHNICAL SUPPORT
  124.         -------------------------------------------------------------------
  125.  
  126.         TECHNICAL SUPPORT
  127.  
  128.         Should you have any questions, suggestions, or run into problems  
  129.         with this or any Sapphire Software product, you can contact me with
  130.         one of the following methods.
  131.  
  132.  
  133.         THE CORAL REEF - My Personal BBS
  134.  
  135.                   The Coral Reef - Node 1  (517) 894-0729   14.4
  136.                   The Coral Reef - Node 2  (517) 894-5052   14.4
  137.                   The Coral Reef - Node 3  (517) 894-0413   28.8
  138.  
  139.         For the most part, I answer my mail on a daily basis so you will
  140.         get a fast reply.
  141.         
  142.         * Note - Calling Node 1 will automatically roll the call over to
  143.                  the other nodes if it is busy.
  144.                
  145.  
  146.         MUSTANG SOFTWARE SUPPORT BBS
  147.  
  148.                 You can also reach me on the Mustang Software Support BBS.
  149.                 I frequent their system a few times a week so you will get
  150.                 a reply but not as fast as if you call my system.
  151.  
  152.  
  153.         INTERNET MAILING
  154.  
  155.                 My internet address is "BRADBURY@CRIS.COM" and use this
  156.                 service a few times a week also.
  157.  
  158.  
  159.         MAILING ADDRESS
  160.  
  161.                 Last but not least, you can reach me via the postal system.
  162.  
  163.                 Address:
  164.                           Scott Bradbury
  165.                           C/O - The Coral Reef
  166.                           1808 N. Golfview Drive  Apt. #6
  167.                           Essexville, Michigan  48732
  168.  
  169.         
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.                                                                            
  178.         -------------------------------------------------------------------
  179.                                                                      Page 2
  180.  
  181.  
  182.  
  183.         RANDOMIZER v1.0                                      FILES INCLUDED        
  184.         -------------------------------------------------------------------
  185.  
  186.         FILES INCLUDED
  187.  
  188.         Your copy of RANDOMIZER is distribued in a singles compressed file.
  189.         This one file contains all the files necessary to run this program.
  190.         If any of the following files are absent from the archive you can
  191.         call The Coral Reef (517) 894-0729 to obtain a complete copy and
  192.         the most current version.
  193.  
  194.         Required files:
  195.  
  196.                 *  RANDOM.WCX    - The Main Program.
  197.                 *  RANDOM.CFG    - Configuration File.
  198.                 *  RANDOM.DOC    - Documentation for Randomizer.
  199.                 
  200.         Display files:
  201.  
  202.                 *  PRELOG1.BBS   - Sample Prelog Display File #1.
  203.                 *  PRELOG2.BBS   - Sample Prelog Display File #2.
  204.                 *  PRELOG3.BBS   - Sample Prelog Display File #3.
  205.                 *  PRELOG4.BBS   - Sample Prelog Display File #4.
  206.  
  207.                 *  GOODBY1.BBS   - Sample Goodbye Display File #1.
  208.                 *  GOODBY2.BBS   - Sample Goodbye Display File #2.
  209.                 *  GOODBY3.BBS   - Sample Goodbye Display File #3.
  210.  
  211.         Miscellaneous files:
  212.  
  213.                 *  FILE_ID.DIZ    - File Information.
  214.                 *  DESC.SDI       - Short Description File.
  215.                 *  HISTORY.DOC    - History and Revisions of Program.
  216.                 *  PRODUCTS.DOC   - List of Products by Sapphire Software.
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.         ------------------------------------------------------------------
  239.                                                                     Page 3
  240.  
  241.  
  242.  
  243.         RANDOMIZER v1.0                             INSTALLATION AND SETUP
  244.         ------------------------------------------------------------------
  245.  
  246.         INSTALLATION AND SETUP
  247.  
  248.         Follow these steps in order and you should have no problem setting
  249.         this program up within a matter of minutes.
  250.  
  251.               1)  YOU SHOULD MAKE A BACKUP COPY OF THIS ARCHIVE AND ANY  
  252.                   PRELOG.BBS AND GOODBYE.BBS FILES(S) YOU HAVE IN YOUR
  253.                   DISPLAY PATH.  (i.e. c:\wildcat\disp\)  These two files
  254.                   will be overwritten during execution of this program.
  255.  
  256.               2)  You will need to create a directory called RANDOM to 
  257.                   hold the configuration file and your display files.
  258.  
  259.                   Example:  (Using drive C:)
  260.  
  261.                       C:          - Makes drive C the active drive.
  262.                       CD\         - Ensure you are in the root directory.
  263.                       MD RANDOM   - Makes the directory "Random".
  264.                       CD\RANDOM   - Changes to the newly created directory.
  265.  
  266.               3)  Copy the archive to the C:\RANDOM directory and then
  267.                   un-compress the file RANDOM10.ZIP.  If you are unfamiliar
  268.                   with copying files then consult your DOS manual.  
  269.                   Information on how to unzip files can be obtained by
  270.                   typing PKUNZIP with no parameters at the DOS prompt.
  271.  
  272.               4)  The configuration file MUST be kept in C:\RANDOM.
  273.                   The following is the contents of the sample configuration
  274.                   file:
  275.  
  276.                   1                 - Current Index of Prelog.BBS file.
  277.                   3                 - Current Index of Goodbye.BBS file.
  278.                   Y                 - Y = Use Goodbye.BBS / N = Don't Use.
  279.                   4                 - Maximum Number of PRELOGx.BBS files.
  280.                   3                 - Maximum Number of GOODBYx.BBS files.
  281.                   C:\RANDOM\        - Path to Config. file and ALL Displays.
  282.                   C:\WILDCAT\DISP\  - Path to PRELOG.BBS/GOODBYE.BBS Files.
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.         -------------------------------------------------------------------
  299.                                                                      Page 4
  300.  
  301.  
  302.  
  303.         RANDOMIZER v1.0                              INSTALLATION AND SETUP
  304.         -------------------------------------------------------------------
  305.  
  306.         INSTALLATION AND SETUP
  307.  
  308.         Line 1:  This is the first random file you want displayed as your
  309.                  PRELOG.BBS file.  You can set this to any number you like
  310.                  as long as it is equal to or less than the maximum number
  311.                  of random files you want to use.  I would start it with
  312.                  the number "1" as it is now.  Zero will not work.
  313.  
  314.         Line 2:  This is the first random file you want displayed as your
  315.                  GOODBYE.BBS file.  (if line 3 is set to "Y").  You can set
  316.                  this to any number you like as long as it is equal to or 
  317.                  less than the maximum number of random files you want to
  318.                  use.  I would start it with the number "1" as it is now.
  319.                  Zero will not work.
  320.  
  321.         Line 3:  This line tells the program whether or not you elect to
  322.                  use the GOODBYE.BBS file as part of the random program.
  323.                  Setting this to "Y" will cause the program to change your
  324.                  GOODBYE.BBS file every time a caller connects.  Setting
  325.                  this to "N" will leave your existing GOODBYE.BBS file in
  326.                  it's original condition.  The index in line 2 will change
  327.                  as the program is used if set to "Y" or "N" but no file 
  328.                  will actually be altered when you have it set to "N".
  329.                  
  330.         Line 4:  This is the maximum number of PRELOGxx.BBS files you want
  331.                  to have for display.  Example:  If you enter a "3" on this
  332.                  line, you will need to have PRELOG1.BBS, PRELOG2.BBS and
  333.                  PRELOG3.BBS in the C:\RANDOM directory.
  334.  
  335.         Line 5:  This is the maximum number of GOODBYxx.BBS files you want
  336.                  to have for display.  Example:  If you enter a "2" on this
  337.                  line, you will need to have GOODBY1.BBS AND GOODBY2.BBS in
  338.                  the C:\RANDOM directory.
  339.  
  340.         Line 6:  This is the original path where the program can find your
  341.                  ORIGINAL PRELOGxx.BBS and GOODBYxx.BBS files.  These are 
  342.                  the files that will be copied to your display path.
  343.                  These files are NOT overwritten.
  344.  
  345.         Line 7:  This is the display path where your PRELOG.BBS and 
  346.                  GOODBYE.BBS files are located.  Typically, Wildcat! will
  347.                  default this path to be C:\WILDCAT\DISP\ and I have kept
  348.                  with this.  These files WILL be overwritten.
  349.  
  350.         * Note - It is very important to include the trailing backslash
  351.                  after the path names in lines 6 & 7.  The drive letter
  352.                  must also be included.
  353.  
  354.  
  355.  
  356.  
  357.  
  358.         ------------------------------------------------------------------
  359.                                                                     Page 5
  360.  
  361.  
  362.  
  363.         RANDOMIZER v1.0                             INSTALLATION AND SETUP
  364.         ------------------------------------------------------------------
  365.  
  366.         INSTALLATION AND SETUP
  367.  
  368.               5)  Copy the file RANDOM.WCX to the C:\WILDCAT\ home
  369.                   directory.  Once you have copied the file you need to
  370.                   rename it to LOGON1.WCX or LOGON2.WCX.  Wildcat searches
  371.                   for either of these files when a user logs on and if
  372.                   present, will execute them.  This will run the program to
  373.                   change the PRELOG.BBS, the GOODBYE.BBS, if option is set
  374.                   to "Y" and updates the index for the next caller.
  375.  
  376.               6)  You will need to draw the display files you would like to
  377.                   use in your PRELOG.BBS and GOODBYE.BBS files.  You will
  378.                   need the number of screens that you put as the maximum
  379.                   in the configuration file.  The files must be named
  380.                   PRELOGxx.BBS and GOODBYxx.BBS where "xx" is a number
  381.                   from 1 to 99.  Do not use a leading zero in front of the
  382.                   numbers 1 thru 9.
  383.  
  384.                   Examples:
  385.  
  386.                        Correct                 Incorrect
  387.  
  388.                        PRELOG1.BBS             PRELOG01.BBS
  389.                        PRELOG25.BBS            N/A
  390.                        GOODBY7.BBS             GOODBY07.BBS
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.       --------------------------------------------------------------------
  419.                                                                     Page 6
  420.  
  421.  
  422.  
  423.       RANDOMIZER v1.0                                            EXECUTION
  424.       --------------------------------------------------------------------
  425.  
  426.       EXECUTION
  427.  
  428.       Once you have your display files created and the main program copied
  429.       in your Wildcat! home directory you are ready to run.  The Randomizer
  430.       will begin copying the next screen as soon as a caller signs on to
  431.       your BBS.  You can test it out by logging on to any node (including
  432.       the local node).
  433.  
  434.       I have this program named LOGON1.WCX which causes it to run just
  435.       before the BBS checks to see if the user has mail.  A brief note 
  436.       with the name of the program, version, author and my BBS name and
  437.       number will be displayed as it updates the display files and the
  438.       index.
  439.  
  440.       You could also run this as the POSTCALL.WCX file.  I ask that you run
  441.       it during LOGON1.WCX or LOGON2.WCX so that credit and advertisement
  442.       for the program is displayed.  If you run it in the logoff sequence
  443.       a user will not see this information.  8(  Running this program in
  444.       the beginning is better especially for multi-node systems.  If a user
  445.       signs on to node 1 the file will be updated within the first minute
  446.       or two that the user is online.  This ses up a new file for a caller
  447.       on node 2 and so on down the line.  If you have to wait until the
  448.       caller logs off it could be a while before it updates the screen all
  449.       depending on what time limit you give to your users.
  450.  
  451.       It is possible two or more callers could call on a BBS at nearly
  452.       the same time.  If so, they may both see the same screen before one
  453.       caller gets to the point where the program executes and updates the
  454.       file.  This will cause no problems.
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.       --------------------------------------------------------------------
  479.                                                                     Page 7
  480.  
  481.  
  482.  
  483.       RANDOMIZER v1.0                                 WARRANTY INFORMATION
  484.       --------------------------------------------------------------------
  485.  
  486.       WARRANTY INFORMATION
  487.  
  488.       RANDOMIZER VERSION 1.0 IS DISTRIBUTED AS SHAREWARE.  THIS PROGRAM
  489.       DOES NOT REQUIRE REGISTRATION NOR DOES IT REQUIRE AN ACCESS KEY FOR
  490.       IT TO OPERATE.
  491.  
  492.       THIS PROGRAM IS GUARANTEED TO DO ABSOLUTELY NOTHING EXCEPT TAKE UP
  493.       DISK SPACE.  USE IT AT YOUR OWN RISK.  NEITHER SAPPHIRE SOFTWARE NOR ANY
  494.       OTHER PERSON INVOLVED IN ITS DISTRIBUTION IS RESPONSIBLE IN ANY WAY,
  495.       FOR ANY DAMAGES RESULTING FROM ITS USE OR MISUSE, DIRECTLY OR
  496.       INDIRECTLY.
  497.  
  498.       THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF RANDOMIZER IS
  499.       ENTIRELY WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME
  500.       THE COST OF ALL NECESSARY SERVICING, REPAIR OR OTHER DAMAGES TO YOUR 
  501.       EQUIPMENT, SOFTWARE, OR OTHER PROPERTY.
  502.  
  503.       SAPPHIRE SOFTWARE IS NOT RESPONSIBLE TO YOU FOR DAMAGES, INCLUDING BUT
  504.       NOT LIMITED TO, ANY LOST PROFITS, LOST MONIES, OR OTHER SPECIAL,
  505.       GENERAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE
  506.       OR INABILITY TO USE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR 
  507.       DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY THIRD PARTIES
  508.       OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS) OR
  509.       ANY OTHER LOSS EVEN IF YOU HAVE BEEN ADVISED OF THE POSSIBILITY OF
  510.       SUCH DAMAGES, OR FOR ANY CLAIM BY ANY OTHER PARTY.
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.         ------------------------------------------------------------------
  539.                                                                     Page 8
  540.  
  541.  
  542.  
  543.         RANDOMIZER v1.0               LICENSING AND DISTRIBUTION AGREEMENT                 
  544.         ------------------------------------------------------------------
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.         ------------------------------------------------------------------
  599.                                                                     Page 9
  600.  
  601.  
  602.  
  603.         RANDOMIZER v1.0                                   ACKNOWLEDGEMENTS
  604.         ------------------------------------------------------------------
  605.  
  606.         ACKNOWLEDGEMENTS
  607.  
  608.         I would like to thank the following peole for their support and 
  609.         help in testing this product and in all my efforts...during both
  610.         the good and bad times.
  611.  
  612.  
  613.              Tammy Bradbury     - My wife, Co-Sysop, and best friend!
  614.  
  615.              Bobbi Gorden       - Coral Reef "Beach Bum" Staff and Support
  616.                                   Beta Tester
  617.  
  618.              Gordon MacQueen    - Coral Reef "Beach Bum" Staff and Support
  619.                                   Beta Tester
  620.  
  621.              Brian Gano         - Sysop of The Chocolate Malt BBS
  622.                                   (517) 686-6974    Beta Testing Site
  623.  
  624.              Russ Sharon        - Sysop of The Office BBS
  625.                                   (517) 893-0127    Beta Testing Site
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.         ------------------------------------------------------------------
  659.                                                                    Page 10
  660.  
  661.